About task extension errors

An unexpected problem may cause a task extension to raise an error. Or, the Execute method of the task extension may return False to indicate some other problem.

In both cases, the Task Server will:

• Terminate the execution of the task.
• Record the error in the Windows Application event log.
• Move the task definition file to the Bad folder. You can inspect this folder to additional details about failed tasks. You may also move the task file back to the Pickup folder to have the Task Server execute it again.

In a production environment, the messages in the Windows Application event log are essential. If you make sure that any error messages generated by your task extension contain useful information (as shown in the follow example code), it will be easier to find and correct the cause of failing tasks.

'  The text of the error raised by the task extension will appear in the Windows application log
If Document is Nothing Then
    Err.Raise -1, "GetDocument", "The document was not found!"
End If